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1.  Introduction 


Text  files  are  often  used  to  store  tabulated  data  and  user-modifiable  inputs  for  scientific 
modeling.  This  report  presents  a  set  of  functions,  written  in  C++,  that  can  be  used  to  read,  write, 
and  parse  text  files.  A  summary  sheet  is  provided  at  the  end  of  this  report.  It  presents  the  ylo 
namespace,  which  contains  the  six  functions  that  are  described  in  this  report. 


2.  Reading  and  Writing  Text  Files 


2.1  ReadTextFile()  Function 

The  ReadTextFile()  function  can  be  used  to  create  a  character  array  that  contains  all  of  the 
information  from  a  text  file. 

Note  that  the  ReadTextFile()  function  uses  the  “new”  command  to  allocate  memory  for  the 
character  array  that  is  pointed  to  by  the  return  value.  Thus,  to  avoid  memory  leaks,  each  use  of 
the  ReadTextFile()  function  should  be  accompanied  by  a  use  of  the  “delete[]”  operator. 

ReadTextFileQ  Code 


inline  char*  ReadTextFile(//<=========READS  A  TEXT  FILE  INTO  A  CHARACTER  ARRAY 

const  char*  f ilename){//< . THE  NAME  OF  THE  TEXT  FILE 

FILE*  f=fopen(filenameJ "rb");// . binary  is  necessary  to  get  n  right 

if( !f)printf("\nCan't  open  \"%s\" . \n", filename) ,exit(l) ; // . is  f  open? 

size_t  n;/*<-*/fseek(f J0JSEEK_END)Jn=ftell(f)Jrewind(f);//. .get  size  of  file 

char*  b=new  char [n+1] ; /*<-*/f read(b, 1, n ,f ) , fclose(f ) b[n]  = ' \0 ' ; // . read  f 

return  b ;// . note  that  b  points  to  newly  allocated  memory 

/  j  <V'N"N»N'YAG  ENAUT^IGMAI  L  •  C ^ ^ ~ ru  ru  nunu  ru  nu  ru  nu  ru  nu rsj r^/ r^t r^t r^/ nu r^/  ^ ^  |J  P  Q^"|~  ^  r^j  2 4NAV 2013  rv,>j'vrsjrs/'v 


ReadTextFile()  Parameters 

filename  filename  specifies  the  name  of  a  text  file. 


ReadTextFile()  Return  Value 

The  ReadTextFile()  function  returns  a  pointer  to  the  beginning  of  a  character  array  that  stores  all 
of  the  information  from  the  input  file. 
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If  the  file  that  is  specified  by  filename  cannot  be  opened,  the  ReadTextFile()  function  calls  the 
exit()  function  with  status  code  1 .  Inability  to  open  a  file  is  typically  the  result  of  an  incorrectly 
specified  filename  or  path. 

2.2  WriteTextFile()  Function 

The  WriteTextFileQ  function  can  be  used  to  write  a  character  array  to  a  text  file. 


WriteTextFile()  Code 


inline  size_t  WriteTextFile(//<========WRITES  A  CHARACTER  ARRAY  TO  A  TEXT  FILE 

const  char*  filename, //< . THE  NAME  OF  THE  TEXT  FILE 

const  char*  text,//<--THE  CHARACTER  ARRAY  THAT  WILL  BE  WRITTEN  TO  THE  FILE 

const  char*  mode="w" ){//< - USE  "w"  TO  OVERWRITE  THE  FILE,  "a"  TO  APPEND 

FILE*  f=fopen(filename,mode); 

if( !f)printf("\nCan't  open  \"%s\" . \n", filename) ,exit(l) ; // . is  f  open? 

size_t  n=fwrite(text,l,strlen(text),f);/*&*/fclose(f);//. .write  file  &  close 

return  n;// . number  of  characters  written  to  the  file 

}//  IVfNf/V/V  YAGENAUT@GMAIL .  COM - LAST~UPDATED~24MAY2013 - 


WriteTextFile()  Parameters 

filename  filename  specifies  the  name  of  the  text  file  that  will  be  written. 

text  text  points  to  a  character  array  that  contains  the  text  that  will  be  written  to  the 

text  file. 

mode  mode  specifies  how  the  text  will  be  written  to  the  output  file.  Use  “w”  to 

overwrite  an  existing  file.  Use  “a”  to  append  to  the  end  of  an  existing  file.  In 
either  case,  if  a  file  with  the  same  name  as  the  output  filename  doesn’t  already 
exist,  a  new  file  will  be  created.  The  default  value  is  “w.” 


WriteTextFile()  Return  Value 

The  WriteTextFile()  function  returns  the  number  of  characters  that  were  successfully  written  to 
the  output  file. 

If  the  file  that  is  specified  by  filename  cannot  be  opened,  the  WriteTextFile()  function  calls  the 
exit()  function  with  status  code  1 .  Inability  to  open  a  file  is  often  the  result  of  an  incorrectly 
specified  filename  or  path.  However,  it  can  also  be  the  result  of  a  file  being  marked  as  read  only, 
as  may  be  the  case  if  a  file  is  open  in  another  program. 

2.3  ReadTextFile()/WriteTextFile()  Example 

The  following  example  first  creates  a  file  named  “example.txt,”  then  reads  the  newly  created  file 
and  displays  its  contents: 
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#include  "y_io. h ''// . <string>, <cstdio> 

int  main(){ 

ylo: :WriteTextFile( "example .txt'V'Hello  World! "); 
char*  s=yIo: : ReadTextFile( "example .txt" ) ; 

printf (”%s\n",s);// . display  the  contents  of  "example.txt" 

delete[]  s; 

J  j  j  r\>  r\>  r\i  r\>  r\>  YAG  E  N  AUT(5)GMA  X  L  •  C  LAS  T^U  P  D  AT  E  24M  A Y  2  0 1 3 


OUTPUT: 

Hello  World! 


3.  Comment  Removal 


3.1  RemoveLineComments()  Function 

The  RemoveLineComments()  function  can  be  used  to  overwrite  line  comments  in  a  character 
array.  A  line  comment  is  a  comment  that  begins  with  some  identifying  set  of  characters  and 
continues  to  the  end  of  the  line.  Memory  that  is  occupied  by  line  comments  isn’t  actually  freed 
by  the  RemoveLineComments()  function.  Instead,  all  of  the  line-comment  characters  are 
replaced  with  a  user-specified  character. 


RemoveLineComments()  Code 

inline  char*  RemoveLineComments(//<===================OVERWRITES  LINE  COMMENTS 

char*  text , //< . A  CHARACTER  ARRAY  CONTAINING  LINE  COMMENTS 

const  char*  start="#", //< - START-OF -COMMENT  INDICATOR 

char  c= '  '){//< - THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

char*  s=text; 

while (s=strstr(Sj  start) )memset(s , c, strcspn(s , "\n\f \r" ) ) ; 
return  text; 

}//  IVfV/V/V  YAGENAUT@GMAIL  .  COM - LAST~UPDATED~24MAY2013 - 


RemoveLineComments()  Parameters 

text  text  points  to  a  character  array  that  contains  the  text  that  will  have  its  line 

comments  overwritten.  Typically,  the  character  array  is  created  using  the 
ReadTextFile()  function. 

start  start  is  used  to  identify  the  beginning  of  a  line  comment.  The  default  value  is 

c  c  specifies  the  character  that  will  be  used  to  replace  the  characters  in  the  line 

comment.  The  default  value  is  a  space. 
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RemoveLineComments()  Return  Value 

The  RemoveLineComments()  function  returns  the  input  pointer  text.  Although  the  pointer  text  is 
unmodified,  the  character  array  that  text  points  to  is  modified. 

3.2  RemoveBlockComments()  Function 

The  RemoveBlockCommentsO  function  can  be  used  to  overwrite  block  comments  in  a  character 
array.  A  block  comment  is  a  comment  that  begins  with  some  identifying  set  of  characters  and 
ends  with  a  different  set  of  identifying  characters.  Block  comments  may  or  may  not  span 
multiple  lines.  Note  that  the  memory  that  is  occupied  by  block  comments  isn’t  actually  freed  by 
the  RemoveBlockCommentsO  function.  Instead,  all  of  the  block-comment  characters  are 
replaced  with  a  user-specified  character. 

RemoveBlockCommentsO  Code 


inline  char*  RemoveBlockComments(//<=================OVERWRITES  BLOCK  COMMENTS 

char*  text, //< . A  CHARACTER  ARRAY  CONTAINING  BLOCK  COMMENTS 

const  char*  start="/*", //< - START-OF -COMMENT  INDICATOR 

const  char*  end="*/",//< - END-OF-COMMENT  INDICATOR 

char  c= 1  '){//< - THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

char*  s=text; 

while (s=strstr(s, start) ){ 

int  t=strstr(s,end)-s+strlen(end);/*<-*/if (t<0)t=0; 
memset(s , c ,t) ; } 
return  text; 

}//  YAGENAUT@GMAIL .  COM - LAST~UPDATED~24MAY2013 - 


RemoveBlockCommentsO  Parameters 

text  text  points  to  a  character  array  that  contains  the  text  that  will  have  its  block 

comments  overwritten.  Typically,  the  character  array  is  created  using  the 
ReadTextFileO  function. 

start  start  indicates  the  beginning  of  a  block  comment.  The  default  value  is 

end  end  indicates  the  end  of  a  block  comment.  The  default  value  is 

c  c  specifies  the  character  that  will  be  used  to  replace  the  characters  in  the  line 

comment.  The  default  value  is  a  space. 

RemoveBlockCommentsO  Return  Value 

The  RemoveBlockCommentsO  function  returns  the  input  pointer  text.  Although  the  pointer  text 
is  unmodified,  the  character  array  that  text  points  to  is  modified. 

3.3  RemoveLineCommentsO/RemoveBlockCommentsO  Example 

The  following  example  begins  by  creating  a  character  array  from  a  text  file  that  contains  both 
line  comments  and  block  comments.  Then,  both  the  RemoveLineComments()  and  the 
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RemoveBlockComments()  functions  are  used  to  remove  comments  from  the  character  array.  The 
contents  of  the  character  array  are  displayed  at  each  step. 


#include  "y_io.h"// . <cstdio> 

int  main(){ 

char*  s=yIo: :ReadTextFile("comment_example.txt"); 
printf ( "ORIGINAL  TEXT:\n%s\n\n"Js); 

printf("LINE  COMMENTS  REMOVED: \n%s\n\n",yIo: :RemoveLineComments(s)); 
printf ("LINE  COMMENTS  AND  BLOCK  COMMENTS  REMOVED : \n%s\n\n " , 
ylo: :RemoveBlockComments(s)); 
delete[]  s; 

}//—  ~~YAGENAUT  (5)GMAI  L .  LAST  ~U  P  DAT  E  D~24-MAY 


comment_example.txt: 

#sample  comment 
Hello/*sample  comment*/  World! 


OUTPUT: _ 

ORIGINAL  TEXT: 

#sample  comment 
Hello/*sample  comment*/  World! 


LINE  COMMENTS  REMOVED: 
Hello/*sample  comment*/  World! 


LINE  COMMENTS  AND  BLOCK  COMMENTS  REMOVED: 
Hello  World! 


4.  Parsing  Character  Arrays 


4.1  Parse()  Function 

The  Parse()  function  can  be  used  to  separate  the  text  contained  in  a  character  array  into  a  set  of 
smaller  character  arrays  called  tokens.  Tokens  are  separated  by  user-defined  delimiting 
characters.  Common  delimiters  are  commas,  tabs,  and  spaces. 

The  Parse()  function  works  by  searching  for  tokens  in  the  character  array  pointed  to  by  the  input 
variable  text.  When  a  token  is  found,  the  delimiting  character  that  immediately  follows  the  token 
is  replaced  by  a  NULL  character.  A  pointer  to  the  beginning  of  the  token  is  stored  in  a  vector. 
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ParseQ  Code 


inline  vector<char*>  Parse(//<=======================================1D  PARSER 

char*  text, //< . THE  CHARACTER  ARRAY  THAT  WILL  BE  PARSED 

const  char*  delimiters="  ,\t\n\f\r"){//<---CHARACTERS  THAT  SEPARATE  TOKENS 
vector<char*>  S(l, text=strtok(text, delimiters));//. .. .output  array  of  tokens 
while (text=strtok(NULL, delimiters ) )S . pushback(text) ; 
return  S; 

}//  YAGENAUT@GMAIL .  COM - LAST~UPDATED~24MAY2013 - 


Parse()  Parameters 

text  text  points  to  the  character  array  that  will  be  parsed.  Typically,  the  character 

array  is  created  using  the  ReadTextFile()  function. 

delimiters  delimiters  specifies  a  set  of  characters  that  separate  tokens.  Any  set  of 

consecutive  delimiter  characters  will  act  as  a  single  delimiter.  For  example, 
suppose  that  the  text  string  “8,„9”  was  parsed  using  the  Parse()  function  and 
with  delimeters  set  to  The  Parse()  function  will  treat  the  set  of  three 
consecutive  commas  as  a  single  delimiter.  Thus,  only  two  tokens  will  be  found. 
By  default,  spaces,  commas,  tabs,  line  feeds,  form  feeds,  and  carriage  returns 
are  all  treated  as  delimiters. 

Parse()  Return  Value 

The  Parse()  function  returns  a  vector  of  pointers.  Each  pointer  points  to  the  beginning  of  a  token. 
The  tokens  are  stored  in  the  character  array  that  was  originally  pointed  to  by  the  text  input 
parameter. 

4.2  Parse2D()  Function 

The  Parse2D()  function  can  be  used  to  separate  the  text  contained  in  a  character  array  into  a  set 
of  smaller  character  arrays  called  tokens.  Tokens  are  separated  by  two  types  of  user-defined 
delimiting  characters.  The  first  set  of  delimiters  separates  tokens  within  a  row  of  data.  Common 
examples  are  spaces,  commas,  and  tabs.  The  second  set  of  delimiters  separate  data  rows. 
Common  examples  are  line  feeds,  form  feeds,  and  carriage  returns. 

The  Parse2D()  function  works  by  searching  for  row  ends  in  the  character  array  pointed  to  by  the 
input  variable  text.  When  a  row  end  is  found,  the  delimiting  character  that  immediately  follows 
the  row  is  replaced  by  a  NULL  character.  The  Parse()  (not  2D)  function  is  then  used  to  parse  the 
row. 
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Parse2D()  Code 


inline  vector<vector<char*>  >  Parse2D(//<==========2D  PARSER  (CALLS  ID  PARSER) 

char*  text , //< . -THE  CHARACTER  ARRAY  THAT  WILL  BE  PARSED 

const  char*  delimiters  =  "  ,\t",//< - PRIMARY  (COLUMN)  DELIMITERS 

const  char*  ends="\n\f \r" ){//< - SECONDARY  (ROW)  DELIMITERS 

vector<vector<char*>  >S;// . output  array  of  tokens 

char*  b,*  c=new  char[strlen(delimiters)+strlen(ends)+l] ; 
strcpy(c ,  delimiters) , strcat(c , ends) ; 

while(*(b=text+strspn(textjC))){// . find  row  start 

text=b+strcspn(bJends),*text=0Jtext++;// . find  row  end 

S .  push_back(Parse(bj delimiters ) ) ;  }// . parse  row 

delete[]  c; 

return  S;//...the  number  of  columns  per  row  may  not  be  the  same  for  all  rows 
}//-'  Y  AG  ENAUT  (fl)GMAI  L .  LAST  ~U  P  D  AT  E  D~  24-MAY  2013~~~~~ 


Parse2D()  Parameters 

text  text  points  to  the  character  array  that  will  be  parsed.  Typically,  the  character 

array  is  created  using  the  ReadTextFile()  function. 

delimiters  delimiters  specifies  a  set  of  characters  that  separate  tokens  within  the  same 
row.  Any  set  of  consecutive  delimiting  characters  act  as  a  single  delimiter. 
Default  values  are  spaces,  commas,  and  tabs. 

ends  ends  specifies  a  set  of  characters  that  separate  rows  of  tokens.  Default  values 

are  line  feeds,  form  feeds,  and  carriage  returns. 


Parse2D()  Return  Value 

The  Parse2D()  function  returns  a  vector  of  vectors  of  pointers.  Each  pointer  points  to  the 
beginning  of  a  token.  The  tokens  are  stored  in  the  character  array  that  was  originally  pointed  to 
by  the  text  input  parameter. 
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4.3  Parse()/Parse2D()  Example 


The  following  example  begins  by  creating  a  character  array  from  a  text  file  that  contains  a  table 
of  numbers.  The  example  parses  the  character  array  first  using  the  Parse()  function,  then  using 
the  Parse2D  function.  Between  the  two  parsings,  the  character  array  is  deleted,  then  recreated. 


#include  "y_io.  h ''// . <cstdio>  ,< vector > 

int  main(){ 

char*  s=yIo: :ReadTextFile("parse_example.txt"); 

printf ( "ORIGINAL  TEXT:\n%s\n\n"Js); 

std: : vector<char*>  A=yIo: :Parse(s); 

printf ("PARSED  TEXT : \n" ) ; 

for(int  i=0;i<9;++i)printf("%s  ,  ”,A[i]); 

delete[]  s; 

s=yIo: : ReadTextFile( "parse_example .txt" ) ; 

std: :vector<std: : vector<char*>  >  B=yIo: :Parse2D(s); 

printf ( "\b\b  \n\n2D-PARSED  TEXT : \n" ) ; 

for(int  i=0; i<3;++i)for(int  j=0;j<3;++j) 

printf ( "%s  ,  %s",B[i][j], j==2?"\b\b  \n":""); 

delete[]  s; 

^  j  /  <vi<vivfv/vivY  AG  E  N  AUT  (o)GMA  XL*  C  LAS  T^U  P  DAT  E  D  ^  2  4NAV  201  3'v'v"n"v,v"v 


parse  sample.txt: 
1.0  2.0  3.0 
4.0  5.0  6.0 
7.0  8.0  9.0 


OUTPUT: 


ORIGINAL  TEXT: 

1.0 

2. 

0  3 

.0 

4.0 

5. 

0  6 

.0 

7.0 

8. 

0  9 

.0 

PARSED  TEXT 

1.0 

2.0 

3 

3.0  ,  4.0  ,  5.0  ,  6.0  ,  7.0  ,  8.0  ,  9.0 

2D- 

PARSED 

TEXT: 

1.0 

3 

2.0 

3 

3.0 

4.0 

3 

5.0 

3 

6.0 

7.0 

3 

8.0 

3 

9.0 
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5.  Summary 


A  summary  sheet  is  provided  at  the  end  of  this  report.  It  presents  the  ylo  namespace,  which 
contains  the  six  functions  that  are  described  in  detail  in  this  report.  Also  presented  is  an  example 
that  can  be  used  to  test  the  performance  of  the  functions  contained  in  the  ylo  namespace. 
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y_io . h 


#ifndef  Y_IO_H_ 

#define  Y_IO_H_ 

#include  <vector> 

#include  <cstdio>//. .  FILE, fopenQ, printf  (),fseek(),SEEK_END,ftell(), . .  .,fclose() 

#include  <cstdlib>// . exit() 

#include  <cstning>/ / . strst n( ) , memset ( ) , strlen( ), strtok( ) 

namespace  yIo{ 
using  std::vector; 

AND  WRITE  TEXT  FILES  @@@@@@@@@@@@@@@@@@@@@@@@@@@ 
inline  char*  ReadTextFile(//<=========READS  A  TEXT  FILE  INTO  A  CHARACTER  ARRAY 

const  char*  filename){//<- . . . - . . THE  NAME  OF  THE  TEXT  FILE 

FILE*  f=fopen(filename, "rb" ) ; // . binary  is  necessary  to  get  n  right 

if ( !f )printf ( "\nCan 't  open  \"%s\" .\n", filename), exit(l);// . is  f  open? 

size_t  n;/*c-*/fseek(f,0,SEEK_END),n=ftell(f ), rewind(f );//. .get  size  of  file 

char*  b=new  char[n+l] ;/*<-*/f read(b, 1, n,f ) ,fclose(f ),b[n]  = ' \0' ;// . read  f 

return  b;// . note  that  b  points  to  newly  allocated  memory 

}  /  / - YAG  E  NAUT@GMAIL .  COM — - LAST-UPDAT  E  D-24MAY20 13 - 

inline  size_t  WriteTextFilg(//<========WRITES  A  CHARACTER  ARRAY  TO  A  TEXT  FILE 

const  char*  filename, //< - THE  NAME  OF  THE  TEXT  FILE 

const  char*  text, //<- -THE  CHARACTER  ARRAY  THAT  WILL  BE  WRITTEN  TO  THE  FILE 

const  char*  mode="w”){//< - USE  "w"  TO  OVERWRITE  THE  FILE,  "a"  TO  APPEND 

FILE*  f=fopen (filename, mode); 

if( !f)printf ("\nCan't  open  \"%s\" .\n", filename), exit(l);// . is  f  open? 

size_t  n=fwrite(text,l, strlen(text),f);/*&*/fclose(f );// . .write  file  &  close 

return  n;// . number  of  characters  written  to  the  file 

}// - YAG ENAUT@G MAIL  .  COM - LAST-UPDATED-24MAY2013 - 

/ / @@@@@@@@@@@@@@@@@@@@@@@@@@  COMMENT  REMOVAL 

inline  char*  RemoveLineComments(//<===================OVERWRITES  LINE  COMMENTS 

char*  text, //< - - A  CHARACTER  ARRAY  CONTAINING  LINE  COMMENTS 

const  char*  start="#",//< - - ---START-OF-COMMENT  INDICATOR 

char  c= '  ’){//< - THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

char*  s=text; 

while (s=strstr(s, start) )memset(s,c,strcspn(s, "\n\f\r") ); 
return  text; 

}// - YAGENAUT@GMAIL .  COM - LAST~UPDATED~24MAY2013 - 

inline  char*  RemoveBlockComtnents(//<=================OVERWRITES  BLOCK  COMMENTS 

char*  text, //<---  — - A  CHARACTER  ARRAY  CONTAINING  BLOCK  COMMENTS 

const  char*  start="/*",//< - - - START-OF-COMMENT  INDICATOR 

const  char*  end="*/",//<-- - - - END-OF-COMMENT  INDICATOR 

char  c= '  '){//< - THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

char*  s=text; 
while(s=strstr(s, start) ){ 

int  t=strstr(s,end)-s+strlen(end); /*<-*/if (t<0)t=0; 
memset(s,c,t);} 
return  text; 

}// - YAGENAUT@GMAIL.COM - LAST~UPDATED~24MAY2013 - 

/ / @@@@@@@@@@@@@@@@@@@@@@@@@@@  STRING  PARSERS  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 
inline  vector<char*>  Parse(//<=======================================1D  PARSER 

char*  text,//< . . . . . THE  CHARACTER  ARRAY  THAT  WILL  BE  PARSED 

const  char*  delimiters="  ,\t\n\f\r"){//<---CHARACTERS  THAT  SEPARATE  TOKENS 
vector<char*>  S(l,text=strtok(text, delimiters));//. .. .output  array  of  tokens 
while (text=strtok (NULL, delimiters ) )S .push_back (text); 
return  S; 

}// - YAGENAUT@GMAIL.  COM - - - LAST~UPDATED~24MAY2013 - 

inline  vector<vector<char*>  >  §arse2||(//<==========2D  PARSER  (CALLS  ID  PARSER) 

char*  text,//< . - . . ------THE  CHARACTER  ARRAY  THAT  WILL  BE  PARSED 

const  char*  delimiters="  ,\t",//<- - - PRIMARY  (COLUMN)  DELIMITERS 

const  char*  ends="\n\f\r"){//< . . - . ---SECONDARY  (ROW)  DELIMITERS 

vector<vector<char*>  >S; // . output  array  of  tokens 

char*  b,*  c=new  char[strlen(delimiters)+strlen(ends)+l]; 
strcpy(c, delimiters), strcat(c,ends); 

while (*(b=text+strspn (text, c) )){// . 


find  row  start 


ylo  Summary 


text=b+strcspn(b,ends), *text=0,text++;// . find  row  end 

S. push_back( Parse (b, delimiters) ); }// . parse  row 

delete[]  c; 

return  S;//...the  number  of  columns  per  row  may  not  be  the  same  for  all  rows 

}  /  / - YAG  E  NAUT@GMA  I L .  COM - LAST-U  PDAT  ED-24MAY20 13 - 

}/ /@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 

#endif 


EXAMPLE 


#include  <ctime> 

#include  <cmath> 

#include  "y_io. h"// . <vector>, <cstdio> 

inline  double  ElapsedTime(){ 
static  int  clocks=0; 

double  time=double(clock()- clocks )/CLOCKS_PER_SEC; 
clocks=clock( ); 
return  time; 

}  /  / - YAG  E  NAUT@GMA  I L .  COM - LAST-U  PDAT  ED-24MAY20 13 - 

int  main(){ 

int  M=10000,N=100;// . number  of  rows  and  columns  in  array 

printf (" - - - TEST  SETUP - - - \n"); 

printf("  number  of  columns  (N)  in  sl,s2,s3:  %d\n",N); 

printf(”  number  of  rows  (M)  in  sl,s2,s3:  %d\n",M); 

printf(”  Characters  per  element:  %d\n",10); 

printf (" - CREATE  si,  FILL  WITH  RANDOM  #S,  &  WRITE  TO  FILE - \n"); 

char*  sl=new  char [M*N*10+1] ;// . storage  for  array 

for(int  i=0;i<M;++i)for(int  j=0; j<N;++j, sl+=10) 

sprintf (si, "%9. 5f%s", rand () /double (RAND_MAX)/100, j==N-l?"\n" :","); 

*sl=0,sl-=(M*N*10);// . terminate  s,  then  reset  s  to  beginning  of  array 

printf ("%15stime  to  create  sl=%8.3f  seconds\n","",ElapsedTime()); 
ylo : : WriteTextFile( "test . txt " , si) ; 

printf(”  time  to  write  si  to  V'test .txt\"=%8. 3f  seconds\n",ElapsedTime()); 

printf (" - CREATE  s2,  FILL  WITH  DATA  FROM  V'test .txt, \"  &  PARSE - \n"); 

char*  s2=yIo: :ReadTextFile("test.txt"); 

printf ("%15stime  to  create  s2=%8.3f  seconds\n", M",ElapsedTime()); 

std: :vector<std: :vector<char*>  >  B=yIo: : Parse2D(s2); 

printf ("%16stime  to  parse  s2=%8.3f  seconds\n", MM,ElapsedTime()); 

printf (" - CREATE  s3,  FILL  WITH  PARSED  DATA,  &  COMPARE  TO  si - \n"); 

char*  s3=new  char[M*N*10+l] ; 

for(int  i=0;i<M;++i)for(int  j=0; j<N;++j, s3+=10) 
sprintf (s3, "%9s%s", B[i] [ j], j==N-l?"\n" :","); 

*s3=0,s3-=M*N*10;// . terminate  s3,  then  reset  s3  to  beginning  of  array 

printf ("%15sTime  to  create  s3=%8.3f  seconds\n", "",ElapsedTime()); 
ylo : : WriteT ext F ile ( " long_ j  unk2 . txt " , s3 ) ; 

printf ("%27ss3=sl?  %s\n", "", ! strcmp(sl, s3) ?"true" : "false"); 

delete[]  sl,delete[]  s2,delete[]  s3; 

}// - YAGENAUT@GMAIL .  COM - LAST~UPDATED~24MAY2013 - 


OUTPUT 


. TEST  SETUP--- . - . - . --- 

number  of  columns  (N)  in  sl,s2,s3:  100 
number  of  rows  (M)  in  sl,s2,s3:  10000 
Characters  per  element:  10 

- CREATE  si,  FILL  WITH  RANDOM  #S,  &  WRITE  TO  FILE . 

time  to  create  sl=  0.670  seconds 
time  to  write  si  to  "test.txt"=  0.047  seconds 

- CREATE  s2,  FILL  WITH  DATA  FROM  "test.txt,"  &  PARSE - 

time  to  create  s2=  0.000  seconds 

time  to  parse  s2=  0.109  seconds 

- CREATE  S3,  FILL  WITH  PARSED  DATA,  &  COMPARE  TO  si . 

Time  to  create  s3=  0.172  seconds 

s3=sl?  true 


NO.  OF 

COPIES  ORGANIZATION 


NO.  OF 

COPIES  ORGANIZATION 


1  DEFENSE  TECHNICAL 
(PDF)  INFORMATION  CTR 
DTIC  OCA 

1  DIRECTOR 

(PDF)  US  ARMY  RESEARCH  LAB 
IMAL  HRA 

1  DIRECTOR 

(PDF)  US  ARMY  RESEARCH  LAB 
RDRL  CIO  LL 

1  GOVT  PRINTG  OFC 
(PDF)  AMALHOTRA 

2  ARDEC 
(PDF)  RDA  REIS  AM 

D  ERICSON 
C  DOUROS 

1  AMRDEC 
(PDF)  RDMR  SSL  T 

G  WIGGS 

2  DRTA 
(PDF)  RDMR  SSL  T 

YSOHN 

JBELL 


RDRL  WML 
M  ZOLTOSKI 
RDRL  WML  A 
M  ARTHUR 
B  BREECH 
P  BUTLER 
B  FLANDERS 
W  OBERLE 
C  PATTERSON 
R  PEARSON 
L  STROHM 
A  THOMPSON 
R  YAGER  (1  PDF,  5  HC) 
RDRL  WML  B 
N  TRIVEDI 
RDRL  WML  C 
S  AUBERT 
RDRL  WML  D 
R  BEYER 
RDRL  WML  E 
P  WEINACHT 
RDRL  WML  F 
D  LYON 
RDRL  WML  G 
J  SOUTH 
RDRL  WML  H 
J  NEWILL 


1  AFRL/RWW 
(PDF)  RDMR  SSL  T 
C  EWING 

1  NAWCAD 
(PDF)  RDMR  SSL  T 
E  LYNCH 

1  NSWCDD 
(PDF)  RDMR  SSL  T 
K  LEWIS 


ABERDEEN  PROVING  GROUND 


30  DIR  USARL 
(5  HC,  RDRLSLBW 
25  PDF)  P  GILLICH 
LHALL 
T  MYERS 
C  KENNEDY 
N  MOHOLKAR 
K  RAFAELS 
RDRL  WM 
P  BAKER 
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